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About This Book 



Purpose 



This manual is intended to help managers and technical personnel evaluate IBM's 
Advanced Interactive Executive (AIX) Family Definition and do some preliminary, 
high-level planning for its implementation. 



Related Information 

More detailed information on the components of the AIX Family Definition will be 
available at a later date. Currently, most of the information can be found in various 
publications for AIX/RT: 

AIX FORTRAN Reference 

AIX FORTRAN Guide 

AIX C Reference 

AIX C Language Guide 

AIX Operating System Commands Reference 

AIX Operating System Technical Reference 

SAA Common Programming Interface, C Reference 

SAA Common Programming Interface, FORTRAN Reference 

Token-Ring Network Architecture Reference. 
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AIX Family Definition Overview 



Chapter 1. Introduction 



Background 



AIX is an IBM-developed family of operating systems based on UNIX. The AIX Family 
provides a compatible operating system environment across the IBM Personal System/2 
80386, RT, 9370, 4381, and 3090 architectures. The family defines a variety of common, 
reusable components to aid the developer in producing portable code and to aid in 
communication between systems of different hardware architectures. 

By pursuing a multiple-architecture strategy, IBM has been able to provide customers with 
a wide choice of functions and hardware to meet their various requirements. Today, 
IBM's systems span a nearly thousand-fold capacity range and support the information 
processing needs of people in very different environments. 

To enhance transition between these systems, to facilitate multi-system use, and to bring 
the breadth of IBM's product line to bear on customer needs in all environments, IBM has 
introduced the AIX Family Definition. The results of the AIX Family Definition include: 

• Applications that can be ported with less effort, or that can span systems 

• Programming skills that have broader applicability 

• User access to these applications that is simpler and more uniform 

• Consistent languages. 

Several popular UNIX implementations have become standards in the UNIX marketplace. 
These standards are integrated into the AIX offerings and complement the other AIX 
Family offerings. 

Content of the AIX Family Definition 

IBM has selected several software interfaces, conventions, and protocols as part of the AIX 
Family Definition. These offerings provide the framework for the AIX Family support and 
give developers a consistent interface across various AIX hardware offerings. These 
interfaces, conventions, and protocols are designed to provide an enhanced level of 
consistency in the following areas: 

Base System The system calls, library routines, and commands that 

are the base of any UNIX system. 

Programming Interface The languages and services that application developers 

use in building their software. 

User Access Interface The way the information is presented, and the way 

users respond. 

Communications Support The connectivity of systems and programs. 

Distributed Processing Support The ability to use the resources of a remotely connected 

system. 

Applications The software that IBM and other vendors develop and 

supply. 

The AIX Family Definition combines the features of the major UNIX offerings available 
today, enhanced in several areas by IBM. The features offered consist of those parts 
defined by the Portable Operating System for Computer Environments (POSIX), plus UNIX 

Introduction 1-1 



System V Release 2, plus 4.3 Berkeley Software Distribution (BSD). Features from all 
these sources have been merged to offer the best environment for the majority of users. 

Advantages for Independent Users 

These specifications are intended to assist two types of users: those who use IBM software 
to build their own applications, and software companies who build applications to sell. 
Using the functions and interfaces defined to be part of the AIX Family Definition will 
ease the porting of UNIX applications across the AIX platforms. 

Relationship to System Application Architecture 

System Application Architecture (SAA) is a framework for developing consistent 
applications that are portable across the future offerings of the IBM System/370, 
System/3X, and Personal Computer. SAA facilitates the development of such applications 
by providing a common collection of selected software interfaces, conventions, and 
protocols that support the three elements of the architecture: Common User Access (CUA), 
Common Programming Interface (CPI), and Common Communications Support (CCS). 

The AIX Family Definition defines IBM's set of offerings that is implemented across 
different IBM hardware architectures, but that uses the same operating system (AIX). AIX 
is the IBM strategic software platform that addresses the fast growing, open-standard 
UNIX market opportunity. With the AIX Family Definition, IBM is providing consistent 
interfaces and protocols for the AIX environment. 

Situations may exist where AIX systems and SAA systems need to be interconnected. It is 
IBM's intent to specify appropriate interconnection protocols between AIX systems and 
SAA systems. 

Customers and software vendors may at times want to port applications between AIX and 
SAA environments. The AIX Family Definition will provide C and VS/FORTRAN 
interfaces that are compatible with the SAA definition for these languages. 

As the AIX Family Definition and SAA evolve, IBM will expand the interconnect 
capabilities and the common programming interfaces. 



Common Base System 



The AIX Base System defines operating system calls, library routines, commands, and 
utilities. All these together provide compatibility with UNIX System V Release 2 and 4.3 
Berkeley Software Distribution (BSD). AIX Systems Architecture allows for the addition of 
future enhancements. IBM is actively participating in the development of the POSIX 
standard. Any changes required to the family definition, due to such standards, will be 
incorporated in the AIX offerings. 

The Base System includes the 8-bit ASCII National Language Support. 



Common Programming Interface 

One of the important parts of the AIX Family Definition is a common programming 
interface: the languages and services used by programmers. The components of the 
interface fall into these three general categories: 

• Programming Languages 

- C 

- VS/FORTRAN 
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• Procedure Languages 

- Bourne Shell 

- C Shell 

• Services 

- Presentation Interface. 

For each component of this programming interface, IBM is establishing a definition, or 
specification. Some of the specifications will be standards produced by external bodies — 
for example, the IEEE 1003 (POSIX) standard, or the ANSI X3J11 standard for the C 
language. Others will be specifications generated internally by IBM to provide consistency 
across its products. 

Common User Interface 

The Common User Interface defines the rules for the dialog between the human and the 
computer. It establishes how information appears on a display screen, and how people 
respond to that information. It includes definitions of interface elements, and rules for 
interaction techniques. This interface includes panel appearance, choice selection, color 
and emphasis, messages, help, and terminology. 

An interface between user and computer has three main components: 

• The way the machine communicates with the user 

• The way the user communicates with the machine 

• What the user understands about the interface. 

The first aspect is what the user perceives: what faces the program and the hardware show 
to the user at the work station, and how the instructions and data are presented. The user 
has to recognize this information, understand it, and come up with an appropriate 
response. This response, consisting of established actions such as key selection or 
mouse movement, is the second aspect of the interface. The third aspect, how users 
understand this entire process, is really part of the first two. As long as the interface 
meets the user's expectations, it is easy to use; and as long as the interface is integrated 
and has good overall design, it is easy to learn. Within AIX, user and machine 
communicate through the shells. 

Another part of the user interface for All Points Addressable (APA) displays is evolving 
and will include objects representing user actions such as buttons and command bars. 

Common Communications Support 

Common Communications Support is used to connect applications, systems, networks, and 
devices. This support will be achieved by the consistent implementation of designated 
communication architecture in each of the AIX Family environments. These 
communication architectures are the building blocks for distributed functions. In the AIX 
products, the Common Communications Support allows the AIX based machines to 
communicate with other IBM operating systems, while still allowing them to participate in 
communications with other UNIX operating systems. 

Included in the Common Communications Support at this time are data streams, session 
services, network and data link controls. Each of these is described in the following 
sections. 
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Data Streams 

Data Streams refer to the data and control information that is transmitted over a data link 
(and that is transmitted within AIX to communicate between routines). Only ASCII data 
streams are part of the AIX Family Definition. 

Data Link Controls 

Token-Ring Network consists of a wiring system, a set of communication adapters 
(stations), and an access protocol that controls the sharing of the physical medium by the 
stations attached to the Local Area Network (LAN). The IBM Token-Ring Network 
architecture is based on IEEE 802.2 and 802.5 standards (for more information, consult the 
Token-Ring Network Architecture Reference). 

Ethernet consists of a set of communications adapters, and an access protocol that 
controls the sharing of the physical medium by the stations attached to the LAN. The IBM 
Ethernet support is based on IEEE 802.3 standards. 

X.25 defines a packet-mode interface for attaching data terminal equipment (DTE) such as 
host computers, work stations, and terminal-to-packet switched data networks. The IBM 
X.25 is based on the CCITT X.25 (1984) standards. 

Communication Services 

The following products are currently supported as AIX Family communications products: 

• TCP/IP 

• uucp. 

Common Distributed Files Systems 

The AIX Family Definition defines the protocols and interfaces that enable AIX systems to 
share available resources and processing power with other AIX and non-AIX systems. 

The current family definition includes the following products: 

• Distributed Services 

• Network File System (NFS). 



Common Applications 



AIX applications are available across the AIX platform. Applications range from simple 
utilities to very specific multi-function applications. 

IBM encourages independent software vendors to port existing UNIX applications or to 
develop new AIX applications based on the AIX Family Definition. 
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Chapter 2. Base System 



Overview 



The AIX Base System defines operating system calls, subroutines, commands, and utilities. 
These provide compatibility with UNIX System V Release 2 and 4.3 Berkeley Software 
Distribution (BSD), and include IBM enhancements. 



System Calls and Subroutines 



The AIX family supports a large number of system calls and subroutines, some of which 
originated in UNIX System V Release 2, some in 4.3 Berkeley Software Distribution (BSD) 
versions of UNIX, and some of which were created especially for the AIX Operating 
System. 

When a system call or subroutine is defined in the POSIX specification, the AIX family 
adheres to the POSIX specification unless otherwise noted in the extended description. 

System calls provide controlled access to the operating system kernel. The programming 
interface to the system calls is identical to that of subroutines. Thus, in a C program, a 
system call is similar to a subroutine call. The difference between the two is that a system 
call does a context switch so that the called routine has access to kernel information and 
operates in kernel mode. When an error occurs, most system calls return a value of -1 and 
set an external variable named errno to identify the error. 

Subroutine Libraries 

The AIX Family supports several subroutine libraries. These libraries are a collection of 
commonly used functions and declarations. The following libraries belong to the AIX 
Family Definition: 

• Standard C Library (libc.a) 

• Standard I/O Package (libc.a) 

• Math Library (libm.a) 

• Curses Library (libcurses.a). 

More libraries are available in the AIX systems to perform specific functions, though they 
are not currently contained in the AIX Family Definition. 

A list of the system calls and library subroutines that are part of the AIX Family 
Definition can be found in the Appendix. 
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User and Administrator Commands and Utilities 

The AIX systems contain a large number of commands and utilities: some acquired from 
the UNIX System V and BSD bases, and many added by IBM. 

Refer to the Appendix for a list of the AIX Family commands. 
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Chapter 3. Programming Interface 



Overview 



Several programming languages are available under AIX. C and VS/FORTRAN have been 
chosen to be part of the AIX Family Definition, as they are two of the most heavily used 
languages in the AIX environment. The following pages provide a description of the 
features of each language, and a high-level list of the language elements that make up the 
Programming Interface. 



C is a programming language designed for a wide variety of programming tasks. It has 
been used for system-level code, text processing, graphics, and for development of 
engineering, scientific, and commercial applications. 

The C language itself is compact, with function added through its library. This division 
makes C both flexible and efficient. Another advantage of C is its consistency across 
different hardware architectures. 

The flexibility of C enables its users to deal easily with machine-level entities at a low 
level, while at the same time having the high-level control and data structures found in 
other modern, structured programming languages. 

Included is an extensive library of functions to provide input and output, mathematics, 
exception handling, string and character manipulation, dynamic memory management, and 
date and time manipulation. Use of this library helps to maintain program portability, 
because the underlying implementation details for the various operations need not be of 
concern to the programmer. 

C supports numerous data types, including characters, integers, floating-point numbers 
and pointers — each in a variety of forms. In addition, C also supports data aggregates 
such as arrays, structures (records), unions, and enumerations. 

The interface specifications have been developed according to the draft of the American 
National Standard Programming Language - C (X3J11). Figure 3-1 on page 3-2 lists the 
language elements currently defined in the C interface for the AIX Family Definition, and 
shows which AIX product implements each interface element. 
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Data Types: 

signed keyword 
volatile keyword 
const keyword 
void * pointers 
enumerated datatype 
long datatype 
double datatype 
unsigned datatype 
float datatype 

Language Features: 

adjacent strings concatenated 

full function prototypes 

ref-def model for externs 

DBCS characters in comments and string-constants 

Standard I/O: 

stdin/stdout/stderr 

remove 

rename 

tmpfile/tmpnam 

fclose 

fflush 

fopen 

freopen 

setbuf 

setvbuf 

Preprocessor Directives: 

if/ifdef/ifndef 

else/endif 

define 

line 

include 

undef 

Escape sequences 

\b\f\n\r\t\vV\" \\ 
\ooo — octal 

Memory Block Operations: 

memcpy/memcmp 
memchr/memset 

Variable Arguments: 

vprintf/vfprintf/vsprintf 

Formatted I/O: 

printf/fprintf/sprintf 

vprintf/vfprintf/vsprintf 

scanf/fscanf/sscanf 



Figure 3-1 (Part 1 of 3). Major Elements of the C Interface 
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Character I/O 
fgetc/getc/getchar 
fputc/putc/putchar 
fgets/gets 
fputs/puts 
ungetc 

Direct I/O 
fread/fwrite 
ftell/fseek 
rewind 

Error-handling 
clearerr 
feof 
ferror 

Mathematical: 

cos/sin/tan 

acos/asin/atan/atan2 

exp/log/loglO 

frexp/ldexp 

modf/fmod 

pow/sqrt 

ceil/floor/fabs 

Bessel functions 

Character Handling: 

Character testing 
isalnum/isalpha/iscntrl 
isdigit/isgraph/islower 
isprint/ispunct/isspace 
isupper/isxdigit 

Character case mapping 
tolower/toupper 

General Utilities: 

String conversion 
atof/atoi/atol 
strtpd/strtol 

Pseudo-random numbers 
rand/srand 

Memory management 
calloc/malloc/realloc 
free 

Environment interactions 
abort 
exit 
getenv 
system 

Searching and sorting 
bsearch/qsort 



Figure 3-1 (Part 2 of 3). Major Elements of the C Interface 
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Integer Arithmetic 
abs 
labs 

String Operations: 

strlen/strstr/strtok/strpbrk 

strcat/stmcat 

strcmp/strncmp 

strcpy/strncpy 

strchr/strrchr 

strspn/strcspn 

Date and Time: 

Time manipulation 
difftime 
time 

Time conversion 
asctime 
ctime 
gmtime 
localtime 

Non-Local Jumps: 

setjmp/longjmp 



Figure 3-1 (Part 3 of 3). Major Elements of the C Interface 
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VS/FORTRAN 



VS/FORTRAN is a programming language designed for mathematical computations and 
other manipulation of numeric data, which makes it especially well-suited to scientific and 
engineering applications. 

Because it is simple and easy to learn, and because it produces efficient code, 
VS/FORTRAN is widely used. It is a convenient and familiar tool for anyone involved in 
mathematical computation. 

The original VS/FORTRAN was developed by IBM. Over the years, IBM has continued 
to enhance the language and to offer on all its systems more powerful and sophisticated 
VS/FORTRAN products with a variety of features. 

The interface specification for VS/FORTRAN provides a language that has the familiar 
simplicity of its predecessors, along with new features. In general, the language elements 
fall into the following two categories: 

• American National Standard Programming Language — VS/FORTRAN, ANSI 
X3.9-1978 (FORTRAN 77), ISO standard, 1539-1980 

• Enhancements to this standard — such as the ability to use names that are up to 31 
characters long. 

Because the AIX specification is based on the ANSI standard, users benefit from: 

• Familiarity with the programming terms and functions 

• Ability to use existing programs currently running on other IBM systems (many of 
which are based on the ANSI 77 standard) 

• Ability to convert standard-conforming programs from non-IBM systems to run on the 
supported IBM architectures. 
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For enhanced programming productivity and ease of use, IBM's specifications contain 
language features beyond the industry standards. 

The following Figure indicates which VS/FORTRAN language elements are part of the AIX 
Family Definition. 



Language Element 

All elements of 1977 ANSI VS/FORTRAN 
INTEGER*2 data type 
LOGICAL*l data type 
COMPLEX*16 data type 

Case-insensitive source 

31-character names 

Underscore character (_) in names 

EQUIVALENCE allows association of character and non-character items 
COMMON allows character and non-character items in same block 
DATA allows data initialization in type statements 

Optional length specification for INTEGER, REAL, COMPLEX, and LOGICAL 
IMPLICIT NONE statement 
Z edit descriptor 

INCLUDE compiler directive 

CONJG, HFIX, and IMAG intrinsic functions 

Bit-manipulation intrinsic functions 



Figure 3-2. Major Elements of the VS/FORTRAN Interface 
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Chapter 4. User Interface 



Overview 



The AIX Family Definition's user interface consists of two procedure languages, which 
execute commands, and a presentation interface, which gives users a set of functions to 
display information. This chapter describes these two forms of communication between the 
user and the computer. 



Procedure Languages 



The AIX Family Definition defines two procedure languages: 

• Bourne Shell 

• C Shell. 

The shell language is a system command interpreter and programming language. It is a 
user program that reads commands typed at the keyboard and arranges for their execution. 
In addition, it can read commands that you have saved in a file. Such a file is usually 
called a shell procedure or a command file. 

A simple command is a sequence of words separated by blanks or tabs. A word is a 
sequence of alphanumeric characters that contains no non-quoted blanks. The first word 
in the sequence usually specifies the name of the command; any remaining words are then 
passed to the named command. 

A pipeline is a sequence of one or more commands separated by a | (vertical bar) or by a A 
(circumflex). In a pipeline, the standard output of each command becomes the standard 
input for the next command. Each command runs as a separate process. 

A filter is a command that reads its standard input, transforms it in some way, then writes 
it to its standard output. A pipeline normally consists of a series of filters. 

A list is a sequence of one or more pipelines. 

Each time the shell executes a command, it carries out substitutions. If the command 
name matches one of the built-in commands, it executes it in the shell process. If the 
command name does not match a built-in command but matches the name of a defined 
function, it executes the function in the shell process. If neither of these cases are true, but 
the command name matches that of an executable file that is a compiled binary program, 
the shell (as parent) spawns a new (child) process that immediately runs the program. If the 
file is executable, but not a compiled program, the shell spawns another instance of itself 
(a subshell) to read the file and execute the commands included in it. 



Bourne Shell 



The Bourne Shell is the default shell shipped with the AIX systems. It is based on the shell 
offered with UNIX System V Release 2. A full description of the shell functions can be 
found in the Commands Reference manual of each product. 

Figure 4-1 on page 4-2 indicates which functions of the Bourne Shell are part of the AIX 
Family Definition. 
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Control Commands: 

for ... in ... do 

case ... in 

esac 

if ... elif ... then ... else 

while ... do 

until ... do 

Built-in Commands: 

: - Does nothing 

.file 

break 

continue 

cd 

echo 

eval 

exec 

exit 

export 

hash 

newgrp 

pwd 

read 

readonly 

return 

set 

shift 

test 

times 

trap 

type 

ulimit 

umask 

unset 

wait 



Figure 4-1. Major Elements of the Bourne Shell 
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C Shell 



The C Shell has many attractive command interpreter features not currently available in 
the Bourne Shell, such as: 

• Job control 

• History 

• Arithmetic functions 

• Command name aliasing. 

On the other hand, the Bourne Shell is superior as a programming language. 

Figure 4-2 indicates which functions of the C Shell are currently defined to be part of the 
AIX Family Definition. 



Control Commands: 
foreach ... end 
if ... then.. .else 
if ... else ... endif 
switch ... breaksw ... case ...breaksw 

. . . default ... endsw 
while ... break ... end 
goto 
exit 

continue 
wait 

Built-in Commands: 

alias 

cd 

chdir 

dirs 

echo 

eval 

exec 

glob 

history 

jobs 

kill 

limit 

login 

logout 

nice 

nohup 

notify 

onintr 

popd 

pushd 

rehash 

repeat 

set 

setenv 

shift 

source 

time 

umask 



Figure 4-2 (Part 1 of 2). Major Elements of the C Shell 
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unalias 

unhash 

unlimit 

unset 

unsetenv 



Figure 4-2 (Part 2 of 2). Major Elements of the C Shell 
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Presentation Interface 

Presentation services provide users with a comprehensive set of functions that allow 
information to be displayed or printed in the most effective manner. 

The presentation interface defined for the AIX Family Definition is the X- Windows 
program, Version 11. 

Overview of X-Windows 

X- Windows is a tool designed to help enhance the usability of the overall application 
processing environment. This is done by providing facilities that help you work with 
existing application programs and help you design and implement new applications. 

X- Windows permits multiple application processes to operate within multiple windows 
displayed on a virtual terminal. You can manage windows directly or with application 
programs. You can hide windows completely or partially. You can update partially hidden 
windows as well as windows that are completely hidden. 

Each window can have a specific character set (font) associated with it. In addition, each 
window can have its own keyboard mapping. This capability permits character sets 
available on the system to be connected to a specific window. 

X- Windows provides the capability to manage both local and remote displays. Remote 
display management can be accomplished with other systems connected through TCP/IP. 

The X- Windows Interface Elements 

The X- Windows interface includes keyboard mapping, X- Windows commands, and 
supported C language subroutines. 

Figure 4-3 and Figure 4-4 on page 4-7 indicate which keyboards, commands, and C 
subroutines are available with X- Windows. 



Keyboard Mapping: 

Austrian/German 
Belgian 

Canadian (French) 
Danish 
English (UK) 
English (US) 
Finnish/Swedish 
French (AZERTY) 
Italian 

Japanese English 
Norwegian 
Portuguese 
Spanish 
Swiss (French) 
Swiss (German) 
VT102 

Commands: 
keycomp 



Figure 4-3 (Part 1 of 2). X- Windows Commands 
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rtxwm 

X 

xclock 

xhost 

xinit 

xopen 

xterm 



Figure 4-3 (Part 2 of 2). X- Windows Commands 
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Display Macros: 

XAllPlanes 

XBlackPixel 

XConnectionNumber 

XDefaultColormap 

XDefaultDepth 

XDefaultRootWindow 

XDefaultScreen 

XDefaultVisual 

XDisplayCells 

XDisplayPlanes 

XDisplayString 

XlmageByteOrder 

XLastKnownRequestProcessed 

XNextRequest 

XOpenDisplay 

XProtocolRevision 

XProtocolVersion 

XQLength 

XRootWindow 

XScreenCount 

XServer Vendor 

XVendorRelease 

XWhitePixel 

Image Format Macros: 

XBitmapBitOrder 

XBitmapPad 

XBitmapUnit 

XDisplayHeight 

XDisplayHeightMM 

XDisplayWidth 

XDisplayWidthMM 

Screen Information Macros: 

XBlackPixelOfSCreen 

XCellsOfScreen 

XDefaultColormapOfScreen 

XDefaultDepthOfScreen 

XDefaultGCOfScreen 

XDefaultScreenOfDisplay 

XDefaultVisualOfScreen 

XDisplayOfScreen 

XDoesBackingStore 

XDoesSaveUnders 

XEventMaskOfScreen 

XHeightMMOfScreen 

XHeightOfScreen 

XMaxCmapsOfScreen 

XMinCmapsOfScreen 

XPlanesOfScreen 

XRootWindowOfScreen 

XScreenOfDisplay 

XWhitePixelOfScreen 

XWidthMMOfScreen 

XWidthOfScreen 



Figure 4-4 (Part 1 of 8). X- Windows Subroutines 
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No-Operation Protocol Request: 

XNoOp 

Freeing Client-Created Data: 

XFree 

Closing the Display: 

XCloseDisplay 

Window Functions: 

XChange Window Attributes 

XCirculateSubwindows 

XCirculateSubwindowsDown 

XCirculateSubwindowsUp 

XConfigure Window 

XCreateSimple Window 

XCreate Window 

XDestroySubwindows 

XDestroyWindow 

XLowerWindow 

XMapRaised 

XMapSubwindows 

XMapWindow 

XMoveResize Window 

XMove Window 

XRaiseWindow 

XResize Window 

XRestack Windows 

XSetWindowBackground 

XSetWindowBackgroundPixmap 

XSetWindowBorder 

XSetWindowBorderPixmap 

XSetWindowBorderWidth 

XTranslateCoordinates 

XUnmapSubwindows 

XUnmap Window 

Window Information Functions: 

XChangeProperty 

XConvertSelection 

XDeleteProperty 

XGetAtomName 

XGetGeometry 

XGetSelectionOwner 

XGetWindowAttributes 

XGetWindowProperty 

XInternAtom 

XListProperties 

XQueryPointer 

XQueryTree 

XRotateWindowProperties 

XSetSelectionOwner 

Graphics Resource Functions: 

XAllocColor 
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XQueryColor 

XQueryColors 

XSetArcMode 
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Graphics Functions: 

XClearArea 

XClearWindow 

XCopyArea 

XCopyPlane 

XCreateFontCursor 

XCreateGlyphCursor 

XCreatePixmapCursor 

XDefineCursor 

XDrawArc 

XDrawArcs 

XDrawImageString 
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XDrawImageStringl6 
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XDrawRectangle 
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XDrawString 
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XFreeFontPath 
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XLoadQueryFont 
XPutlmage 
XQueryBestCursor 
XQueryFont 
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XSetFontPath 
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XUnloadFont 

Window Manager Functions: 

XActivateScreen Saver 
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XAddToSaveSet 

XAllowEvents 
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XChangeKeyboardControl 
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XChangeKeyboardMapping 

XChangePointerControl 

XChangeSaveSet 

XDeleteModifiermapEntry 

XDisableAccessControl 

XEnableAccessControl 

XForceScreenSaver 

XFreeModifierMap 

XGetlnputFocus 

XGetKeyboardControl 

XGetKeyboardMapping 

XGetModifierMapping 

XGetPointerControl 

XGetPointerMapping 

XGetScreenSaver 
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XGrabKey 

XGrabKeyboard 

XGrabPointer 
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XInstallColormap 
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XListHosts 
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XQueryKeymap 
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XSetCloseDownMode 
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XSetScreenSaver 

XUngrabButton 

XUngrabKey 

XUngrabKeyboard 

XUngrabPointer 

XUngrabServer 

XUninstallColormap 

XWarpPointer 

Event-Handling Functions: 

XChecklfEvent 

XCheckMaskEvent 

XCheckTypedEvent 

XCheckTypedWindowEvent 

XCheckWindowEvent 

XDisplayName 

XEventsQueued 

XFlush 

XGetErrorDatabaseText 
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XGetErrorText 

XGetMotionEvents 

XlfEvent 

XMaskEvent 

XNextEvent 

XPeekEvent 

XPeeklfEvent 

XPending 

XPutBackEvent 

XSelectlnput 

XSendEvent 

XSetAfterFunction 

XSetErrorHandler 

XSetlOErrorHandler 

XSync 

XSynchronize 

XWindowEvent 

Predefined Property Functions: 

XFetchName 

XGetClassHint 

XGetlconName 

XGetlconSizes 

XGetNormalHints 

XGetSizeHints 

XGetStandardColormap 

XGetTransientForHint 

XGetWMHints 

XGetZoomHints 

XSetClassHint 

XSetCommand 

XSetlconName 

XSetlconSizes 

XSetNormalHints 

XSetSizeHints 

XSetStandardColormap 

XSetStandardProperties 

XSetTransientForHint 

XSetWMHints 

XSetZoomHints 

XStoreName 

Application Utility Functions: 

XAddPixel 

XClipBox 

XCreateBitmapFromData 

XCreatelmage 

XDestroylmage 

XCreateRegion 

XDestroyRegion 

XEmptyRegion 

XEqualRegion 

XFetchBuffer 

XFetchBytes 

XGeometry 

XGetDefault 
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XKeyCodeToKeysym 
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XParseGeometry 
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XPolygonRegion 
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XSetRegion 

XShrinkRegion 

XStoreBuffer 

XStoreBytes 

XStringToKeysym 

XSublmage 

XSubtractRegion 

XUnionRectWithRegion 

XUnionRegion 

XWriteBitmapFile 

XXorRegion 

Context Manager: 

XDeleteContext 
XFindContext 
XSaveContext 
XUniqueContext 

Resource Manager: 

Xrmlnitialize . 

XrmUniqueQuark 

XrmStringToQuark 

XrmQuarkToString 

XrmStringToQuarkList 

XrmStringToBindingQuarkList 

XrmPutResource 

XrmPutLineResource 

XrmPutStringResource 

XrmQPutResource 

XrmQPutStringResource 

XrmPutFileDateBase 

XrmGetStringDataBase 

XrmGetFileDataBase 

XrmMergeDataBases 
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Chapter 5. Communications Support 



Overview 

The AIX Family-defined communications support specifies the protocols that interconnect 
systems. The protocols selected have been chosen from UNIX and industry standards. 

For interconnecting AIX systems, any of the following supported protocols and physical 
connections can be chosen. In addition to the services defined for each AIX environment, 
other communications services, provided in certain environments, expand the 
communications capabilities available to AIX users. 

As IBM extends the AIX Family Definition, communications architectures from UNIX, 
popular industry standards, and IBM's SAA will be evaluated for inclusion in the AIX 
communications support. 

Communications Services 

TCP/IP protocols have been chosen for connecting AIX and non-IBM systems. TCP/IP 
networks are defined for Ethernet and Token-Ring Network, with routing between multiple 
networks. 

The following DARPA (Defense Advanced Research Projects Agency) standard interfaces 
have been chosen as part of the AIX Family Definition: 

TCP Transmission Control Protocol 

UDP User Datagram Protocol 

IP Internet Protocol 

DOMAIN Domain Name Server Protocol 

* SMTP Simple Mail Transfer Protocol 

FTP File Transfer Protocol 

Telnet Remote Login Protocol 

BSD Sockets provide the network transparent interface for TCP/IP protocols. 

The UNIX to UNIX copy protocol (uucp) is included for asynchronous link connections 
between AIX and other UNIX systems. ANSI 3.64 protocol supports the connection of 
asynchronous ASCII terminals. A number of asynchronous link connections (RS232, RS422) 
are included. 



Communicating Application Support 

The X- Windows (Version 11) protocol is supported over TCP/IP networks for transparent 
distribution of presentation graphics. This capability allows an application to run on one 
system and to present text and graphics on the display of another system in the network. 

BSD SENDMAIL is included as a general network mail router to communicate between 
local and remote systems, and among multiple remote protocols. A command-level interface 
provides transparency for mail applications from the underlying mail-handling protocols. 
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Overview 

The AIX Family Definition defines the protocols and interfaces that enable AIX systems to 
share available resources and processing power with other AIX systems 'or with other 
UNIX systems. 

The goal of Distributed Processing is to provide a high degree of transparent resource 
sharing facility. Transparent file sharing is a common capability, with variations in the 
granularity, performance, administration, security, locking, and integrity of the shared 
systems. Additional functions include the transparent sharing of other devices, such as 
printers. The programming interfaces for distributed devices are the same as for local 
system devices. 

Another common capability is the ability to support Distributed Processing applications. 
The interface function for local/remote process transparency varies depending on the 
Distributed Processing facility selected. 

The definitions included in the AIX Family Definition are: 

• Distributed Services (DS): DS/IP protocol has been defined for Distributed Processing 
among a small to large number of AIX systems. DS provides a stateful architecture for 
transparent file sharing, file-level remote mounts, inherited mounts, cross-system file 
locking, and for local/remote process transparency of Inter-Process Communications 
(IPC) message queues. 

DS also provides facilities for flexible network configurations for both resource sharing 
and administration. This includes user and node authentication, network 
administration facilities, and program/code server management techniques. 

• Network File System (NFS) Version 3.2 of Sun Microsystems protocol is included for 
Distributed Processing among AIX and non-IBM UNIX systems. NFS is a stateless 
architecture for transparent file sharing, directory-level remote mount, yellow pages 
directory lookup, and the Remote Procedure Call (RPC) interface for remote 
processing. 

Distributed Services 

Distributed Services (DS) provides distributed operating system capabilities for the AIX 
operating systems. These include distributed files with local/remote transparency, a form of 
single-system image and distributed process communication. The distributed file design 
supports traditional AIX and UNIX file systems. This support allows applications, 
including data management/database applications, to be used in the distributed 
environment without modification to existing object code. 

The key achievements of DS are: 

• Local/remote transparency of the services which are distributed, including no 
noticeable performance degradation in the remote case, and no alteration of the basic 
AIX and UNIX semantics. 

• User isolation from network media and transport mechanisms. 

• Administrative control. This control includes the ability to administer a set of 
interconnected machines as a single domain, or to independently administer machines 
such as servers or private machines. 
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Distributed Data 

Distributed Services uses remote mounts to allow users to mount file systems on a different 
machine than the directory off which the file system is mounted. Once the remote mount is 
established, the files contained in the file system appear in the same directory hierarchy 
across the distributed configuration, and file system calls generally work identically 
regardless of whether the file is local or remote to the user. 

Distributed Processing 

Distributed Services provides distributed processing support through AIX message queues. 

Network File System 

The Network File System (NFS) is a facility for sharing files in a heterogeneous 
environment of machines, operating systems, and networks. Sharing is accomplished by 
mounting a remote file system, then reading or writing files in place. 

NFS is designed as a distributed file system that permits client systems to access shared 
files on a remote system. Client machines request resources provided by other machines, 
called servers. A server machine makes particular file systems available, which client 
machines can mount as local file systems. Thus, users can access remote files as if they 
were on the local machine. 

Yellow Pages Service 

The Yellow Pages (YP) is a network service to ease the job of administrating networked 
machines. The YP is a centralized read-only database. For a client on NFS, this means that 
an application's access to data served by the YP is independent of the relative locations of 
the client and the server. The YP database on the server provides password, group, 
network, and host information to client machines. 



RPC/XDR Services 

The Remote Procedure Call (RPC) facility provides a mechanism whereby one process (the 
client process) can have another process (the server process) execute a procedure call, as 
if the client process had executed the procedure call in its own address space. Because the 
client and the server are now two separate processes, they no longer have to live on the 
same physical machine. 

The External Data Representation (XDR) is a network standard to which RPC protocols 
are converted before being sent over the wire. 

RPC Library Routines 

RPC library routines allow C programs to make procedure calls on other machines across 
the network. To do this, the client must first call a procedure to send a data packet to the 
server. Upon receipt of the packet, the server calls a dispatch routine to perform the 
requested service, and then sends a reply. Finally, the procedure call returns to the client. 

The Network File System RPC library routines will be defined in the Network File System 
reference manual. 
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XDR Library Routines 

These routines allow C programmers to describe arbitrary data structures in a 
machine-independent fashion. Data for remote procedure calls are transmitted using these 
routines. 

The Network File System XDR library routines will be defined in the Network File System 
reference manual. 



LIBRPCSVC 

This library contains the RPC service library routines. This set of routines is used by 
several of the RPC-based commands and util ities. They are also available to a C 
programmer as library routines. To use the RPC service library routines, link with 
librpcsvc.a. 

The Network File System RPCSVC library routines will be defined in the Network File 
System reference manual. 
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Appendix. Comparison of AIX Platforms 



Overview 



This appendix contains a general summary of functions across the IBM AIX family of 
products. It compares AIX interfaces with the proposed IEEE POSIX specifications, with 
UNIX System V, and 4.3 Berkeley Software Distribution (BSD). 

Included in each matrix is a column showing which functions are defined as part of the 
AIX Family Definition. Interfaces within AIX Family Definition are available on one or 
more of the AIX products in the current releases, and will be available across the AIX 
family of products. 

Also included are columns showing where the function is defined as part of the POSIX 
standard, or part of the AT&T System V Interface Definition (SVID) or BSD systems. 

An indication that a function is supported does not guarantee that it is exactly equivalent 
with the POSIX, SVID, or 4.3 BSD implementation. The AIX compatibility priority is as 
follows: POSIX first, then SVID and 4.3 BSD. In many cases, AIX interfaces are provided to 
offer compatibility with more than one of the other UNIX systems, even if those systems 
are not compatible with one another. Functions defined as AIX Family will be compatible 
across AIX products. The full specification of AIX interfaces will be available in the AIX 
product publications, and in general it will be functionally equivalent across all family 
platforms. 



System Calls and Library Routines 



This section of the appendix deals with System Calls and Library Routines. The 
information presented in Figure A-2 on page A-3 groups all the functions found in all of 
the systems chosen for this comparison. 

Information for the AIX columns of Figure A-2 on page A-3 has been extracted from 
Version 1.1.0 of AIX PS/2, Version 2.2.1 of AIX/RT, and Version 1.1.0 of AIX/370. 

Information for the SVID column of Figure A-2 on page A-3 was obtained from the AT&T 
System V Interface Definition, Volumes 1, 2, and 3. 

Information for the BSD column was taken from Berkeley Software Distribution manuals 
for Version 4.3. 

Data for the POSIX column came from draft 12 of P1003.1 for System Calls and Library 
Routines. POSIX is continuing to define standards in several areas; as these standards are 
adopted, the matrix will be updated to show the new status. 

Where both POSIX and another system are indicated, AIX intends to comply with the 
POSIX definition. 
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Figure A-l provides a key to the matrix columns. 



Column 


Definition 


AIX PS/2 


An x in this column indicates that the system call, library routine, 
or user command is supported by AIX PS/2 Version 1.1.0. 


AIX/RT 


An x in this column indicates that the system call, library routine, 
or user command is supported by AIX/RT Version 2.2.1. 


AIX/370 


An x in this column indicates that the system call, library routine, 
or user command is supported by AIX/370 Version 1.1.0. 


AIX Family 


An x in this column indicates that the system call, library routine, 
or user command has been defined as part of the AIX Family 
system. A description of these functions will be available in the 
AIX Technical Reference manual, available at a later date. 




A w in this column indicates that the system call, library routine, 
or user command is defined as a part of the Family (currently PS/2, 
3086, and RT), which will be supported by work station products 
only. 


POSIX 


A 1 (one) in this column indicates that the system call, library 
routine, or user command is defined in the 1003.1 POSIX 
specification. 




An A in this column indicates that system call, library routine, or 
user command is defined in the ANSI X3J11 Standard for the C 
Programming language. This standard is not yet ratified. 


SVID 


A two-letter code in this column indicates that the system call, 
library routine, or user command is defined in the AT&T System V 
Interface Definition (SVID). The possible codes and their meanings 
are: 




BA Base System 

KE Kernel Extensions 

BU Basic Utilities Extensions 

AU Advanced Utilities Extensions 

AS Administered Systems Extensions 

SD Software Development Extensions 

TI Terminal Interface Extensions 


BSD 


An x in this column indicates that the system call, library routine, 
or user command is defined in 4.3 Berkeley Software Distribution 
(BSD). 
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A-32 AIX Family Definition 



User Commands 



This section of the Appendix deals with system User Commands. The list of functions 
presented in Figure A-3 on page A-34 is a union of the User Commands found in AIX, 
POSIX, SVID, and BSD. System administration or system management commands are not 
included. 

This table does not include references to BSD commands contributed by users. It does 
include references to mail handler commands, which are supported on all AIX products. 
These commands are indicated by (mh) following the command name. Refer to Figure A-l 
on page A-2 for a key to the table colums. 
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